Release 10.1A: OpenEdge Development:
Progress 4GL Reference

CREATE X-DOCUMENT statement

Creates a handle for an XML document object. To use the XML document, you must add new nodes using the CREATE-NODE( ) method, the CREATE-NODE-NAMESPACE( ) method, or populate the document from an existing file using the LOAD( ) method.

Note: To ensure consistency across all nodes in an XML document, use either the CREATE-NODE-NAMESPACE( ) method or the CREATE-NODE( ) method to build an XML document; do not use both methods within a single document.

Syntax

CREATE X-DOCUMENT handle [ IN WIDGET-POOL widget-pool-name ]

handle

A variable of type HANDLE into which CREATE X-DOCUMENT stores the new handle.

IN WIDGET-POOL widget-pool-name

An expression of type CHARACTER that evaluates, at run time, to the name of the widget pool that contains the XML document object.

Note: Widget pool names are not case-sensitive.

Example

The following code fragment depicts creating an XML document object:

DEFINE VARIABLE hXdoc AS HANDLE. . . . CREATE X-DOCUMENT hXdoc. . . .

See also

CREATE X-NODEREF statement, DELETE OBJECT statement, X-document object handle, X-noderef object handle